home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games Extra 1996 June / Amiga Games Extra 1996 #6.iso / spiele / publicdomain / a-tanx / tanx.doc < prev    next >
Text File  |  1996-04-04  |  20KB  |  519 lines
  1. DevWare note:  (Note that this game requires your Amiga to have the Fatter
  2.                 Agnus chip which gives you 1 or 2 megs of chip ram--NOT
  3.                 the 512K version of Agnus---the game WILL work if you only
  4.                 have 512K of chipram, but you will not be able to view the
  5.                 bottom portion of the screen.)
  6.  
  7.  
  8.                            AMIGA TANX
  9.                           ~~~~~~~~~~~~
  10.                      Produced by Gary Roberts.
  11.                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  12.                      Version 1.1 ( See changes )
  13.                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  14.  
  15.  
  16.                      Tanks! a Short Overview.
  17.                     ~~~~~~~~~~~~~~~~~~~~~~~~~~
  18.  
  19.  Do you remember that great game called "TANKS !" which appeared
  20. on several machines many years ago.? You don't.?,where have you been
  21. all this time.? 
  22.  Many an hour was had by kids and adults alike playing this simple
  23. game at college and at work. Its one of those games, you either love
  24. it or hate it.
  25.  
  26.  I am afraid I don't know who created the original Tanks,so I can not
  27. give them any credit. ( If somebody knows who it was then please contact
  28. me, I can then give them credit.! )
  29.  
  30.  Anyway Tanks is a 2 player game only ( Although I have known a few
  31. people who play in on their own! ),each player is given a tank to
  32. control on a landscape,the idea is to take it in turns to shoot at your
  33. opponent. ( See.? I said it was simple ). You have control over the
  34. angle of the tanks barrel and the velocity behind the shot.
  35.  The winner is the person who scores a direct hit on their opponents
  36. tank. ( Cooo, now there is a surprise.)  
  37.  Thats the basic idea behind the original Tanks game, now here
  38. is my version.
  39.  
  40.  
  41.                              Amiga Tanx.
  42.                             ~~~~~~~~~~~~~
  43.  Amiga Tanx follows the same lines as the original game,but with just
  44. a few variations.
  45.  
  46.     a) Randomly generated Landscapes.
  47.     b) Two main types of Landscapes.
  48.     c) Variable gravity.
  49.     d) Variable wind strength and direction.
  50.     e) Targets to hit.
  51.     f) Objects which affect the flight of the tanks shot.
  52.     g) Full Stereo Sound.
  53.     h) 50 frames a second screen update.
  54.     i) Parallax scrolled play area.
  55.     j) Over 100 colours on screen. ( Honest ! )
  56.     
  57.  I could go on ,but I won't.
  58.  
  59.  
  60.                             Starting Tanx
  61.                            ~~~~~~~~~~~~~~~
  62.  Pretty straight forward this bit.
  63.  The Tanx game takes up around 400k of chip ram,so if you don't
  64. have 1 meg chip ram or own an amiga A3000,you will have to close
  65. all windows and make sure you have at least 400k of chip ram free.
  66.  
  67.  NOTE: if you only have a 512k amiga,then tanx will not run from
  68. Workbench. You will have to boot the disk and run Tanx from the CLI
  69.  
  70.  Tanx can only be run from the CLI,but due a to a lovely program
  71. called ICONX, you can run it from Workbench.
  72.  To run Amiga Tanx,open up the Tanx window and double click on the
  73. Tanx Icon. A CLI window will appear and Tanx will proceed to run.
  74.  If any errors occur then a nice message will appear on screen.
  75.  
  76.  Tanx can be run from the CLI alone.To do this you must make the "Tanx!"
  77. directory the current directory before running.
  78.  
  79.  Eg.
  80.       CD df0:Tanx!   - To change directory.
  81.       
  82.  If Tanx cannot find or load the file "Tanx-Title.Dat" then it will not run.
  83.  It looks for "Tanx-Title.Dat" in the current directory.
  84.  
  85.  If you wish to transfer the Tanx Game to Hard disk or some other 
  86. media,then you require the following files from the Tanx! directory.
  87.  
  88.        Tanx    ( And the associated icon files if you wish )
  89.        Tanx-Title.Dat
  90.  
  91.    
  92.  "Tanx" is the main program,while "Tanx-Title.Dat" is the title image.
  93. As long as both files are in the same directory, Tanx will run.
  94.  So you can transfer the game to Hard disk or some other media.
  95.  The game is OS friendly and returns the Operating system intact upon
  96. exiting. If other programs are running, they will be stopped whilst
  97. TANX is playing, but on exiting TANX, they will continue to run with out
  98. problems.        
  99.  
  100.                        Playing The Game
  101.                       ~~~~~~~~~~~~~~~~~~
  102.  
  103.  When the Tanx title appears, press the left mouse button, after a few
  104. seconds the Main Options Screen will appear.
  105.  
  106.  From this screen you can change many game parameters.
  107.  The parameters will be explained later on.
  108.  
  109.  To Play a game simply move the mouse pointer and click on the PLAY
  110. Icon situated in the top right of the screen.
  111.  
  112.  After a few seconds you will be shown the Landscape on which the 
  113. battle is about to take place.
  114.  ( The Landscape is about 2 screens wide. )
  115.  
  116.  A control panel,then drops down from the top of the screen.
  117. From here the current player can control his/her tank and scroll
  118. around the landscape.
  119.  
  120.  The current Players name is displayed and their tank is brought
  121. into view. 
  122.  The following Icons are displayed in the panel.
  123.  
  124.  Velocity      - Represented by bar bells. ( What else? ) 
  125.                  Clicking on the arrows underneath will
  126.                  alter the velocity of the players shot.
  127.                  If you hold the left mouse button down then
  128.                  the velocity will rise slowly,hold down both
  129.                  left and right mouse buttons and the velocity
  130.                  will rise quickly.
  131.                  Velocity can be in the range of 0 to 199.
  132.  
  133.  Angle         - Represented by a 90 degree angle.
  134.                  Clicking on the arrows underneath will
  135.                  alter the angle of the tanks gun barrel.
  136.                  Click with the left button alone and the value
  137.                  will change slowly.Hold down both mouse buttons
  138.                  and things will wizz along.
  139.                  The angles are in degrees.
  140.                  Values are between -90 and 150
  141.                  Negative angles will fire the bullets downwards.
  142.                  + 90 degrees will fire the bullets straight up.
  143.                                   
  144.  Fire          - Represented by a rocket on a red button.
  145.                  If you are happy with the angle,velocity and tanks
  146.                  position,then click on this to fire your bullet!
  147.    
  148.  Quit          - Represented by a white flag.
  149.                  Clicking on this during any point in play will
  150.                  quit the current game and return to the options
  151.                  screen.
  152.  
  153.  Scroll Land   - Represented by a small landscape and tank.
  154.                  Click on the arrows will scroll the Landscape
  155.                  Left and right, and up and down. this will enable
  156.                  you to pick out your target ( The other players
  157.                  tank ).
  158.                  Pressing the left mouse button will scroll slowly.
  159.                  Hold down both buttons and it will wizz along.   
  160.  
  161.  Move Tank     - Represented by a Tank ( Suprising huh.? )
  162.                  Clicking on the arrows below the icon will move
  163.                  your tank.
  164.                  Tanks can only move on their flat plain.
  165.                  They can not go up or down hills or ride over
  166.                  craters.
  167.  
  168.  When you fire the bullets, they will fly given your angle and
  169. velocity. The bullets are accurately calculated using
  170. a projectile forumla,so they will act as if in real life.
  171.  
  172.  Each player takes it in turn to fire a shot. the first player to
  173. hit their opponents tank wins.! 
  174.  
  175.  After a game has been won. A status screen is displayed.
  176.  A tally of the games won by each player is displayed.
  177.  
  178.  From the Status screen you can play another game with the current
  179.  parameters or you may exit to the Main Options screen to alter 
  180.  the parameters. -  See Next section.
  181.  
  182.  The current tally of the games won by each player is only
  183.  cleared when you change the players name from the main options
  184.  screen.   - See next section.
  185.  
  186.  
  187.                            Game Parameters.
  188.                           ~~~~~~~~~~~~~~~~~~
  189.  As you may have seen from the Main Options screen there are lots
  190. of parameters that you can change.
  191.  
  192.                A) Wind Strength.
  193.                B) Wind Direction.
  194.                C) Gravity Strength.
  195.                D) Landscape generation.
  196.                E) Objects.
  197.                F) Sound.
  198.  
  199. Also on the Main options screen you will find the following Icons.
  200.  
  201.  ABOUT    -   The current version of the game and who wrote it!
  202.  
  203.  QUIT     -   Quit the game. 
  204.  
  205.  PLAYER1  -  
  206.  PLAYER2  -   The two player icons at the top left of the
  207.               main options screen enable you to alter the 
  208.               players names.Simply click on the icon under the
  209.               players name. You may type in 3 letters from the
  210.               keyboard or move your mouse left/right and click to
  211.               leave a character.
  212.  
  213.  PLAY     -   Play a game with the selected parameters.
  214.   
  215.  I will run through each of the parameters and explain 
  216. what they all do!
  217.  To operate any of the options,simply move the mouse pointer
  218. over the switches ( little boxes with black or red lights in them )
  219. and press the left mouse button.
  220.  
  221.  
  222.                        A) Wind Strength.
  223.                       ~~~~~~~~~~~~~~~~~~~
  224.  Pretty obvious this one. You can introduce wind affect
  225. into the game. Wind affects the flight of the bullets and
  226. makes the game a little harder to play.
  227.  The wind strength and direction is displayed during the game,
  228. at the bottom of the screen. The flag denotes the direction,whilst
  229. the meter and number ( from 0-9 ) denotes the strength.
  230.  
  231.  The options under Wind Strength are as follows.
  232.  
  233.   1) None   -     No wind affect at all. The default option.
  234.   
  235.   2) Light  -     Light wind.A small breeze blows and has a 
  236.                   small affect on the bullets flight.
  237.  
  238.   3) Medium -     A brisk wind blows across the landscape.
  239.                   This wind noticeably affects the bullets
  240.                   flight.
  241.                   
  242.   4) Strong -     Definitely gale force conditions now.
  243.                   The wind is very strong and the bullets
  244.                   are very much affected by the wind.
  245.                   
  246.   5) Random -    The wind strength is randomly chosen
  247.                   during the game.After each players shot
  248.                   the wind can change strength with this option.                 
  249.                   
  250.  NOTE: With options 2-4 the wind strength is chosen at the
  251.        beginning of a game and does NOT change throughout the
  252.        game.
  253.        With option 5. The wind strength is randomly chosen,
  254.        and DOES change during a game.So watch the wind meter
  255.        before taking a shot.!!!
  256.  
  257.           
  258.                          B) Wind Direction
  259.                         ~~~~~~~~~~~~~~~~~~~
  260.  This option rightly alters how the wind direction is generated.
  261.  
  262.  1) Same.   -     The default option.
  263.                   The wind direction is chosen randomly at the start
  264.                   of each game and does not change during that game.
  265.   
  266.  2) Random  -     The wind direction is chosen randomly at the start
  267.                   of each game,but it can change randomly during a game
  268.                   so watch out!!!                  
  269.      
  270.  
  271.  
  272.                         C) Gravity Strength
  273.                        ~~~~~~~~~~~~~~~~~~~~~                   
  274.  
  275.  No prizes for guessing what this does.
  276.  Different gravity strengths require different tactics.
  277.  
  278.  All gravity is chosen at the start of each game,and does NOT
  279.  change during the game.
  280.    
  281.   1) Light  -     Light Gravity,makes the bullets feel very light.
  282.                   When fired they will tend to float along.
  283.                  
  284.                     
  285.   2) Medium -     This is the default option and is equivalent to
  286.                   the earths gravity.
  287.    
  288.   3) Strong -     The bullets feel very heavy and drop like an
  289.                   elephant wearing several lead anvils as ear rings.
  290.  
  291.   4) Random -     The Gravity is randomly chosen from the above.
  292.  
  293.  
  294.                      D) Landscape Generation.
  295.                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~      
  296.  There are two types of landscapes. Mountains and Foothills.
  297.  For each type the landscape is randomly generated,so no two
  298.  landscapes will be the same.
  299.  
  300.  During landscape and object creation,a small message appears
  301. on screen informing you. - See the Known Bugs Section.!!! 
  302.  
  303.   1) Mountains-   Steep mountains with large valleys.
  304.                   This makes hitting tanks quite tricky.
  305.                   Lots of cover.
  306.  
  307.   2) Foot Hills-  Shallow valleys with small hills.
  308.                   Tanks are easily spotted and not to difficult
  309.                   to get at.
  310.                                    
  311.   3) Random   A Totally random landscape is generated.
  312.                   Watch out!! some bizarre shapes can be
  313.                   generated with this option.
  314.  
  315.  
  316.                   
  317.                          E) Objects.
  318.                         ~~~~~~~~~~~~~   
  319.  
  320.  These are not for the faint hearted.!
  321.  4 types of objects can be placed on the landscape.
  322.  
  323.  All the objects are placed randomly on the landscape.
  324.  
  325.  NOTE: See the Known Bugs section !!!
  326.        
  327.        1) Targets. - These can be destroyed,if you hit a target
  328.                      you will get a free shot the next round.
  329.                               
  330.        2) Fans     - These can not be destroyed.
  331.                      These blow ( What else do fans do.? )
  332.                      very hard in the direction they face.
  333.                      If the bullets fly into range of one of these
  334.                      expect strange results.!
  335.                      A fans wind strength is usually stronger than
  336.                      a strong wind. A fans strength is randomly
  337.                      chosen.
  338.  
  339.        3) Pushers  - These strange objects look like pulsating
  340.                      red pyramids. ( With an arrow going up and down)
  341.                      When ever a bullet flies over them it will be
  342.                      pushed upwards very hard.
  343.                      
  344.        4) Pullers -  These look like a pair of jaws opening and closing.
  345.                      These have the opposite affect of the Pushers.
  346.                      When ever bullets fly over them they will be pulled
  347.                      down very sharply.
  348.                      
  349.                      
  350.                             F) Sound
  351.                            ~~~~~~~~~~
  352.  If you wish you may switch off all sounds during the game.
  353.  All the sounds are digitised and played in full stereo,so why
  354.  should you want to switch the sound off.?
  355.  
  356.  
  357.                     Some other things I should mention,
  358.                   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  359.  
  360.  No two games of Tanx will be the same. Most of the parameters
  361. I use to generate landscapes and object positions are randomized
  362. as much as possible. ( This was right pain debugging the code! )
  363.  
  364.  The tanks are randomly positioned on the landscape, players are
  365. randomly assigned tanks to use.The player that goes first is also
  366. randomly chosen. So don't complain if your mate always goes first!!
  367.  
  368.  Tanks are limited to moving on their "flat plain" only,they can not
  369. go up mountains or over craters.
  370.  But you are able to "Tunnel" your way into a nearby mountain.
  371.  Simple position your tank about a tanks width from the mountain or 
  372. hill,set your angle to -4 or -5 and velocity to over 100.
  373.  The explosion of the bullets hitting the land,will remove a hefty
  374. chunk of land.repeat this a few times and you will have created
  375. a tunnel.Drive your tank in for cover!! But your tank must be able to
  376. fire out of it!  
  377.  
  378.  Try setting the landscape to Foothills,wind to strong,gravity
  379. to light. Fun ain't it.? Be careful not to shoot yourself.!!
  380.  
  381.  It is best to start of with the default options, no wind,medium
  382. gravity and no objects. As soon as you find this to easy,introduce
  383. wind and different gravity strengths.
  384.  
  385.  Finally try switching on the following and playing for the
  386.  hardest level.
  387.  
  388.    1) All objects on
  389.    2) Random Wind strength
  390.    3) Random Wind Direction
  391.    4) Random Gravity
  392.    5) Random Landscape.
  393.    
  394.  
  395.     Have fun!!!
  396.   
  397.  
  398.  Technical Information.
  399. ~~~~~~~~~~~~~~~~~~~~~~~
  400.  
  401.  Due to the nature of the system and how the game operates,this 
  402. game does not multitask. Sorry!!!.
  403.  When you exit the game it will return the system exactly as it
  404. found it.
  405.  To achieve the 50 frames a second,The system must be taken over.
  406. Sorry!
  407.  
  408.  The actual game runs in low res 320*256 and in full PAL overscan.
  409.  Screen update is at arcade speed (50 frames a second)
  410.  6 bitplanes are used to produce dual playfields. using the copper
  411.  over 100 colours are displayed on screen.
  412.  
  413.  The options screen and status screens are all in 32 colours.
  414.  
  415.  Full stereo sound is used. Turn up the volume and increase the
  416. bass to annoy the peeps next door!!
  417.  Over 100 k is used for digitised sound,280 k of graphic data
  418. and 20k of code.
  419.  
  420.  The game was written using an Amiga A500,with A590 Hard drive,3 meg,
  421. 2 drives and monitor.It was written in Assembler using the brilliant
  422. Hisoft Devpac 2.14 and took about 1 month to write.
  423.  Dpaint III was used for graphics.
  424.  Audio Master II was used to digitise the sounds.
  425.  Pixmate was also used for conversion of IFF images to RAW bitplane
  426. files.
  427.  
  428.  The game will run on all Amigas,that includes A3000's and
  429. accelerated Amigas.
  430.  If the game does not run on your setup,please contact me and
  431. I will try to fix the problem.
  432.  If you come across any bugs or have some new ideas for the next
  433. release again, please contact me.
  434.  
  435.  My Address.
  436.      Gary Roberts
  437.      17 Tudor Close,
  438.      Birchwood Drive
  439.      Alderholt
  440.      Near Fordingbridge
  441.      HANTS
  442.      SP6 3LY
  443.      ENGLAND.
  444.      
  445.  
  446.  This is Version 1.1 of TANX.
  447.  
  448.   Thank you for playing it.!
  449.  
  450.             Gaz Robertz 1991.
  451.             
  452.  
  453.  
  454.  Known Bugs.
  455. ~~~~~~~~~~~~~
  456.  The only bug that could occur is during the generation of
  457. Object Positions on the landscape.
  458.  
  459.   i.e. You have 1 or more of the object options switched on.
  460.  
  461.  I have tried to keep the games parameters and randomized as
  462. possible.This way no two games will be the same.
  463.  
  464.  The landscape is generated randomly. Several points are generated
  465. and these joined together to form the land.
  466.  When it comes to generating the object positions,the program
  467. sits in a loop.
  468.  It generates random positions for the objects.It then checks to see
  469. if the newly generated object positions are actually on land. ( We
  470. don't want targets floating in the sky now do we.? )
  471.  If they are not on land then it generates some more random points,
  472. this loop continues until all object positions are on the land.
  473.  
  474.  Now in theory,the computer could sit in this loop for ever,generating
  475. random points which do not lie on the land. ( This has never
  476. happened during the 2 weeks of play testing ).
  477.  
  478.  Because of this I have provided an "exit" function. Whilst the
  479. object positions are being generated,a message appears on screen
  480. telling you so. You can exit out of this by holding down the
  481. left mouse button,this will bring you to the Main Options screen.
  482. ( Don't worry the players scores will not be cleared )
  483.  
  484.  During the 2 weeks of play testing the longest it has taken to 
  485. generate a landscape with all objects switched on is 11 secs.
  486.  If it takes longer that say 30 secs to do so,then I suggest you
  487. exit and try again.
  488.  
  489.  I do appologise about this,but I think the importance of randomizing
  490. parameters as much as possible outways the importance of this bug.
  491.  
  492.  I hope this bug does not annoy you.
  493.  
  494.  Thank you.
  495.   
  496.   
  497.  Updates
  498. ~~~~~~~~~
  499.  
  500.  
  501. Original Tanx completed 14/02/91
  502.  
  503.  
  504. Change Date 25/07/91
  505.  
  506.  1) Fixed bullet collision bug. Bullets sometimes hit the tanx, but passed
  507.     through not registering a hit.
  508.     
  509.  2) Negative wind values were being generated. Fixed.
  510.  
  511.  3) Randomizing routine made faster. Generating of landscapes is quicker.
  512.  
  513.  4) Keyboard routine reworked. 
  514.  
  515.  
  516. Last update 25/07/91
  517.  
  518.                                                                
  519.